home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_3 / paths1.0 / docs / italiano.doc < prev    next >
Text File  |  1993-03-10  |  14KB  |  399 lines
  1. È permesso riprodurre e distribuire copie di questo manuale, a condizione che
  2. rimanga intatto su tutte le copie il copyright e l'avviso del permesso stesso.
  3.  
  4.    Non viene data alcuna garanzia che i programmi descritti in questo manuale
  5. siano affidabili al 100%. State usando questo materiale a vostro proprio
  6. rischio. L'autore *non può* essere fatto responsabile per danni causati
  7. dall'utilizzo di questi programmi.
  8.  
  9.    Questo pacchetto è distribuibile gratuitamente, fermo restando il copyright
  10. dell'autore, Enrico Fedrigo. Ciò significa che è possibile copiarlo
  11. liberamente senza richiedere più di un costo simbolico di copia. Questo costo
  12. *non deve* essere superiore ai 5$ US.
  13.  
  14.    È permesso includere questo pacchetto in collezioni di Public-Domain, in
  15. particolare nella Fred Fish Amiga Disk Library (inclusa la versione CD ROM).
  16. Il file di distribuzione può essere messo a disposizione nei Bulletin Board
  17. Systems o siti FTP. Se si vuole distribuire questo programma *deve* essere
  18. utilizzato l'archivio originale  `Paths1_0.lha'.
  19.  
  20.  
  21. Paths v1.0
  22. ***********
  23.  
  24.  
  25. Copyright
  26. **********
  27.  
  28.    Copyright (C) 1993
  29.  
  30.    È permesso riprodurre e distribuire copie di questo manuale, a condizione
  31. che rimanga intatto su tutte le copie il copyright e l'avviso del permesso
  32. stesso.
  33.  
  34.    Non viene data alcuna garanzia che i programmi descritti in questo manuale
  35. siano affidabili al 100%. State usando questo materiale a vostro proprio
  36. rischio. L'autore *non può* essere fatto responsabile per danni causati
  37. dall'utilizzo di questi programmi.
  38.  
  39.    Questo pacchetto è distribuibile gratuitamente, fermo restando il copyright
  40. dell'autore, Enrico Fedrigo. Ciò significa che è possibile copiarlo
  41. liberamente senza richiedere più di un costo simbolico di copia. Questo costo
  42. *non deve* essere superiore ai 5$ US.
  43.  
  44.    È permesso includere questo pacchetto in collezioni di Public-Domain, in
  45. particolare nella Fred Fish Amiga Disk Library (inclusa la versione CD ROM).
  46. Il file di distribuzione può essere messo a disposizione nei Bulletin Board
  47. Systems o siti FTP. Se si vuole distribuire questo programma *deve* essere
  48. utilizzato l'archivio originale  `Paths1_0.lha'.
  49.  
  50.  
  51. Indirizzo
  52. **********
  53.  
  54.    L'autore può essere raggiunto ai seguenti indirizzi:
  55.  
  56. Indirizzo postale
  57.  
  58.               Enrico Fedrigo
  59.               via Giacomo Leopardi, 6
  60.               31033 Castelfranco Veneto (Treviso)
  61.                     ITALY
  62.  
  63. Posta elettronica su InterNet:
  64.  
  65.           fedro@sabrina.dei.unipd.it
  66.           fedro@paola.dei.unipd.it
  67.  
  68.  
  69. Introduzione
  70. *************
  71.  
  72.    Paths è un editor di preferenze che sopperisce ad una carenza del
  73. WorkBench.
  74.  
  75.    Con Paths non saranno più necessarie 20 o 30 righe di aggiunte ai path di
  76. sistema sulla vostra "User-Startup", ma una sola riga (o anche nessuna,*note
  77. Installazione::.).
  78.  
  79.    Paths è inteso sia come una utility da utilizzare al boot per impostare i
  80. path che vi servono nel normale lavoro, sia per impostare o rimuovere al volo
  81. path locali o globali.
  82.  
  83.    Paths è il mio secondo programma che ho deciso di rendere pubblico e per
  84. questo, sapendo che potrà essere usato da molti utenti, sono stato attento ad
  85. aderire a tutti gli standard Commodore. Perciò la finestra è font-sensitive
  86. e di tipo AppWindow, i file con cui opera sono IFF, risponde al comando
  87. "version", possiede sia l'interfaccia CLI che WorkBench e i menu sono gli
  88. stessi di tutte gli altri editor di preferenze.
  89.  
  90.  
  91. Installazione
  92. **************
  93.  
  94.    L'installazione è molto semplice:
  95.  
  96.    - Copiate "Paths" e "Paths.info" nella directory "SYS:prefs". Se il vostro
  97.      processore è il 68030 o 68040 potete utilizzare una versione ottimizzata
  98.      per questi processori nominata "Paths.030". Potete copiare questa
  99.      versione rinominandola "Paths".
  100.  
  101.    - Se è presente il catalogo nella vostra lingua, copiatelo in
  102.      LOCALE:Catalogs/<lingua>. Se non lo è potete usare il catalogo vuoto
  103.      Paths.ct riempiendolo in tutti i suoi campi: se me lo spedite lo
  104.      includerò nella prossima versione.
  105.  
  106.    - avviate Paths
  107.  
  108.    - utilizzate l'opzione "Leggi la lista di sistema" del menu "Editor"
  109.  
  110.    - Cancellate col bottone "Canc" tutti i paths che vengono impostati dal
  111.      sistema nella Startup-Sequence, quali(1):
  112.  
  113.           C: S: SYS:Tools SYS:Tools/Commodities SYS:Utilities
  114.           SYS:Rexxc SYS:System SYS:Prefs SYS:WbStartup
  115.  
  116.    - Controllate se fate uso dei vostri paths nella User-Startup:
  117.  
  118.         * Se non è cosi:
  119.  
  120.              - Salvate la lista nella directory "SYS:WbStartup" con "Salva
  121.                come..." del menu "Progetto"
  122.  
  123.         * Altrimenti:
  124.  
  125.              - Salvate la configurazione col bottone "Salva"
  126.  
  127.              - Scrivete prima del primo riferimento ai vostri paths:
  128.  
  129.                     SYS:Prefs/Paths USE GLOBAL
  130.  
  131.    L'installazione è completata.
  132.  
  133.    ---------- Footnotes ----------
  134.  
  135.    (1)  Attenzione: non troverete i nomi simbolici C:, S: etc., ma il loro
  136. nome completo
  137.  
  138.  
  139. Uso
  140. ****
  141.  
  142.    Paths possiede sia l'interfaccia CLI che l'interfaccia WB. Lanciando il
  143. programma da WorkBench si potranno modificare solo i path globali, mentre
  144. lanciando Paths da shell si potranno modificare anche i path locali di quella
  145. shell senza toccare i path globali del WorkBench. In modalità "Preferenze"
  146. oltre a modificare la lista di path che sarà operante a partire dal
  147. successivo reboot, verrà modificata anche la lista corrente (locale o
  148. globale). Si cambia modalità con l'opzione "Preferenze" del menu "Editor".
  149.  
  150.    Una differenza importante è che in modalità "Preferenze" i path vengono
  151. aggiunti (senza doppioni) a quelli correnti, diversamente i nuovi path
  152. sostituiscono completamente i vecchi.
  153.  
  154.    Specificando il flag "EDIT" o lanciando Paths da WorkBench viene attivata
  155. la finestra di editing.
  156.  
  157.    Lanciando il programma dall'icona, si può variarne il comportamento
  158. specificando alcuni tooltypes. Naturalmente tali tooltypes possono essere
  159. indicati anche sulle icone progetto che Paths ha creato e da cui può essere
  160. lanciato.
  161.  
  162.    Per aggiungere un nuovo percorso è sufficiente clickare sul gadget `Agg'.
  163. Viene richiesto automaticamente un nuovo Target. Il bottone "Canc" rimuove la
  164. destinazione indicata.
  165.  
  166.    L'ordine della lista è assai importante: la directory che contiene i
  167. comandi di uso più frequente dovrebbe apparire al primo posto, per
  168. ottimizzare gli algoritmi di ricerca del sistema operativo. Potete variare
  169. l'ordine semplicemente selezionando uno dei paths e operando con i tasti
  170. "Primo" "Su" "Giù" "Ultimo" che,come ovvio, spostano il path selezionato al
  171. primo posto, in su di un posto, in giù di un posto, all'ultimo posto.
  172.  
  173.    Un altro metodo per aggiungere destinazioni consiste nel prendere l'icona
  174. che termina il percorso voluto (directory o device) e lasciarla sopra la
  175. finestra di Paths. Con questo metodo si possono indicare più destinazioni
  176. contemporaneamente.
  177.  
  178.    Se l'icona era un file di preferenze valido, verrà caricato.
  179.  
  180.    Clickando su una destinazione si può modificare il path attraverso il
  181. gadget stringa, oppure, con un doppio click, attraverso un file requester.
  182.  
  183.    Altre possibilità sono offerte dai menu.
  184.  
  185.    Infine gli ultimi tre bottoni:
  186.  
  187. *`Salva'
  188.      Salva su disco (ENVARC:)la configurazione, esegue le modifiche ed esce.
  189.  
  190. *`Usa'
  191.      Salva su ram (ENV:) la configurazione, esegue le modifiche ed esce. Tale
  192.      configurazione non sarà disponibile al successivo boot.
  193.  
  194. *`Annulla'
  195.      Esce senza salvare e senza eseguire gli assegnamenti
  196.  
  197.    Naturalmente, come ogni editor di preferenze anche Paths può essere
  198. lanciato in una sola copia allo stesso tempo: lanciare una seconda copia
  199. produce il risultato di portare in primo piano la finestra di Paths e
  200. attivarla.
  201.  
  202.  
  203. Esecuzione da CLI
  204. ******************
  205.  
  206.    Da CLI, il template (ottenibile con `Paths ?') è:
  207.  
  208.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,BOX3D/S,PREFERENCE/K,GLOBAL/K
  209.  
  210.     -`FROM'
  211.           indica il file da caricare al posto di "ENV:Sys/Path.prefs". La
  212.           chiave FROM può essere omessa e si può indicare semplicemente il
  213.           file.
  214.  
  215.     -`EDIT' [Default]
  216.           Caricato il file delle preferenze, apre la finestra di editing e ne
  217.           permette la modifica
  218.  
  219.     -`USE'
  220.           Caricato il file delle preferenze, esegue immediatamente gli
  221.           assegnamenti ed esce.
  222.  
  223.     -`SAVE'
  224.           Salva permanentemente su "ENVARC:Sys/Path.prefs" il file delle
  225.           preferenze, esegue immediatamente gli assegnamenti ed esce.
  226.  
  227.     -`PUBSCREEN' <pub screen name>
  228.           Apre la finestra di editing sullo schermo pubblico indicato.
  229.  
  230.     -`BOX3D'
  231.           I gadgets sono contornati da un box à la NeXT. Dato che non si
  232.           tratta di uno standard di Amiga, con questo flag lo si può
  233.           escludere.
  234.  
  235.     -`PREFERENCE'
  236.           Di default il programma permette di modificare il file di preferenze
  237.           e di aggiungere paths. Specificando questo flag si ottiene l'esatta
  238.           immagine di tutti i path presenti nel sistema (locali o globali) e
  239.           si possono modificare, aggiungere o rimuovere.
  240.  
  241.     -`GLOBAL'
  242.           Di default il programma lanciato da shell agisce solo localmente alla
  243.           shell di partenza. Specificando questo flag si possono editare i path
  244.           globali.
  245.  
  246.      Si può passare dalla modalità locale a quella globale anche dopo la
  247.      partenza del programma, operando sul CYCLE-gadget presente.
  248.  
  249.  
  250. ToolTypes
  251. **********
  252.  
  253.    I ToolTypes messi a disposizione e che possono apparire anche sulle icone
  254. prodotte da Paths sono:
  255.  
  256.     -`EDIT' [Default]
  257.           Caricato il file delle preferenze, apre la finestra di editing e ne
  258.           permette la modifica
  259.  
  260.     -`USE'
  261.           Caricato il file delle preferenze, esegue immediatamente gli
  262.           assegnamenti ed esce.
  263.  
  264.     -`SAVE'
  265.           Salva permanentemente su "ENVARC:Sys/Path.prefs" il file delle
  266.           preferenze, esegue immediatamente gli assegnamenti ed esce.
  267.  
  268.     -`CREATEICONS=YES|NO' [Default = YES]
  269.           Indica se creare oppure no anche un'icona con i files creati
  270.           dall'opzione `Save As...' dei menu (*note Menu::.).
  271.  
  272.     -`PUBSCREEN=<pub screen name>'
  273.           Apre la finestra di editing sullo schermo pubblico indicato.
  274.  
  275.     -`BOX3D=YES|NO' [Default = YES]
  276.           I gadget sono contornati da un box à la NeXT. Dato che non si
  277.           tratta di uno standard di Amiga, con questo flag lo si può
  278.           escludere.
  279.  
  280.    I Tooltype EDIT,USE e SAVE possono essere specificati anche nella forma:
  281.  
  282.      ACTION=EDIT | USE | SAVE
  283.  
  284.  
  285. Menu
  286. *****
  287.  
  288.     *`Progetto'
  289.          -`Apri...'
  290.                Permette di caricare un file di preferenze salvato in
  291.                precedenza.
  292.  
  293.          -`Salva come...'
  294.                Salva il contenuto delle liste. Se il flag CREATEICONS è YES,
  295.                associa anche un'icona da cui si può far partire Paths. Il
  296.                tooltype (*note ToolTypes::.) di default è `ACTION=USE'
  297.  
  298.          -`Fine'
  299.                Termina il programma
  300.  
  301.     *`Editor'
  302.          -`Leggi la lista di sistema'
  303.                Legge tutti gli assegnamenti presenti al momento attuale nel
  304.                sistema, rilasciando eventuali assegnamenti editati fino a quel
  305.                punto.
  306.  
  307.          -`Preferenze'
  308.                Passa dalla modalità Preferenze in cui si può editare il file
  309.                di preferenza e i path vengono aggiunti all'ambiente selezionato
  310.                alla seconda modalità operativa in cui si modificano i path
  311.                attualmente presenti nell'ambiente selezionato.
  312.  
  313.          -`Ripristina ultimi valori'
  314.                Ricarica gli assegnamenti salvati l'ultima volta in ENVARC: e
  315.                rilascia gli eventuali assegnamenti editati fino a quel punto.
  316.  
  317.          -`Annulla modifiche'
  318.                Ricarica gli ultimi assegnamenti validi da ENV: e rilascia gli
  319.                eventuali assegnamenti editati fino a quel punto.
  320.  
  321.     *`Opzioni'
  322.          -`Genera icone'
  323.                (Flag) Indica se associare o no un'icona al file generato con
  324.                l'opzione "Salva come...". Allo startup prende il valore
  325.                indicato dal tooltype (*note ToolTypes::.) CREATEICONS; se non
  326.                esiste per default vale YES
  327.  
  328.  
  329. Distribuzione
  330. **************
  331.  
  332.    L'archivio completo con cui viene distribuito Paths comprende:
  333.  
  334.      Paths1.0.info
  335.      Paths1.0/Paths                        * versione per ogni processore
  336.      Paths1.0/Paths.030                    * versione ottimizzata per 68030/881
  337.      Paths1.0/Paths.info
  338.      Paths1.0/Docs.info
  339.      Paths1.0/Docs/Italiano.doc            * documentazione in plain ASCII
  340.      Paths1.0/Docs/Italiano.doc.info
  341.      Paths1.0/Docs/Italiano.guide          * documentazione in AmigaGuide
  342.      Paths1.0/Docs/Italiano.guide.info
  343.      Paths1.0/Docs/Italiano.dvi            * documentazione in DVI
  344.      Paths1.0/Docs/Italiano.dvi.info
  345.      Paths1.0/Docs/Italiano.texi           * sorgente in TeXinfo
  346.      Paths1.0/Docs/Italiano.texi.info
  347.      Paths1.0/Docs/English.doc
  348.      Paths1.0/Docs/English.doc.info
  349.      Paths1.0/Docs/English.guide
  350.      Paths1.0/Docs/English.guide.info
  351.      Paths1.0/Docs/English.dvi
  352.      Paths1.0/Docs/English.dvi.info
  353.      Paths1.0/Docs/English.texi
  354.      Paths1.0/Docs/English.texi.info
  355.      Paths1.0/Locale/Catalogs/Italiano/Assigns.catalog
  356.      Paths1.0/Locale/Catalogs/Assigns.ct
  357.  
  358.    Verificate che siano presenti tutti questi files
  359.  
  360.  
  361. Sviluppi futuri
  362. ****************
  363.  
  364.    Ridurre l'occupazione di memoria: per ora mi sono limitato a produrre un
  365. programma funzionante ed affidabile. La prossima versione sarà ottimizzata
  366. anche in termini di spazio.
  367.  
  368.    Sto considerando l'ipotesi di scrivere la prossima versione di Paths in C++
  369. e cominciare a studiare degli oggetti per la programmazione sotto AmigaDOS.
  370.  
  371.  
  372. Versioni
  373. *********
  374.  
  375.    Paths1.0: prima versione resa pubblica.           Non ci sono versioni
  376. precedenti :-)
  377.  
  378.  
  379. Ringraziamenti
  380. ***************
  381.  
  382.    Desidero ringraziare per i test fatti e per i suggerimenti forniti(1):
  383.  
  384.      Alessandro Borille    paride@sabrina.dei.unipd.it
  385.      Eugenio Castellani    aj2@sabrina.dei.unipd.it
  386.      Fabio D'Alessi        phobia@sabrina.dei.unipd.it
  387.      Sergio Fantinel       ik3fan@paola.dei.unipd.it
  388.      Jacopo Farinato       redi@sabrina.dei.unipd.it
  389.      Gianluigi Nusca       gigio@paola.dei.unipd.it
  390.      Emanuele Verza        alien@sabrina.dei.unipd.it
  391.  
  392.    In particolare Alessandro ed Eugenio per le loro traduzioni dall'italiano
  393. all'inglese.
  394.  
  395.    ---------- Footnotes ----------
  396.  
  397.    (1)  I nomi sono rigorosamente in ordine alfabetico
  398.  
  399.